docfix: `extern crate` uses `lib.name`; default is post '-' => '_' substitution

diff --git a/src/doc/manifest.md b/src/doc/manifest.md
index 675841784d70938793131113360a738048bc824e..b0354841f57dbb45367df223e4800b7bbc30ed27 100644 (file)
--- a/src/doc/manifest.md
+++ b/src/doc/manifest.md
@@ -484,7 +484,9 @@ specified.
 
 [lib]
 # The name of a target is the name of the library that will be generated. This
-# is defaulted to the name of the package or project.
+# is defaulted to the name of the package or project, with any dashes replaced
+# with underscores. (Rust `extern crate` declarations reference this name;
+# therefore the value must be a valid Rust identifier to be usable.)
 name = "foo"
 
 # This field points at where the crate is located, relative to the `Cargo.toml`.